Skip to content

i18n(ja): unify columnar terminology to a single term - #23634

Open
yahonda wants to merge 2 commits into
i18n-ja-release-8.5from
fix-columnar-term-unification
Open

i18n(ja): unify columnar terminology to a single term#23634
yahonda wants to merge 2 commits into
i18n-ja-release-8.5from
fix-columnar-term-unification

Conversation

@yahonda

@yahonda yahonda commented Aug 27, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Unifies Japanese renderings of the storage-architecture concept "columnar" to a single term, following the direction already decided in a prior term-notation review. Each EN term maps 1:1 to one JA term — no two distinct EN words were collapsed into the same JA term (see the mapping table below).

EN → JA mapping (before / after)

EN term JA before (mixed) JA after Sites Notes
"columnar" (e.g. "columnar storage engine", "columnar format", "columnar data") 列指向 / カラム型 / 列ベース / カラムナー / 列形式 (5-way 表記揺れ) 列指向 39 Unified to the pre-existing dominant term.
"column-based" (e.g. "TiKV (row-based) or TiFlash (column-based)") 列ベース 列ベース (unchanged) 6 A genuinely different EN word from "columnar" — kept distinct, not merged into 列指向, even though the two EN words describe the same underlying architecture.
"column type" (schema/data-type concept, unrelated to storage architecture) カラム型 カラム型 (unchanged) 1 (releases/release-8.5.7.md) False friend — same JA string as the storage term but a different EN concept ("skipped column types such as JSON"). Left untouched.

27 files, 39 sites converted to 列指向.

Method / verification

Every site that had a candidate rendering was checked individually against its own exact EN sentence (not inferred from a handful of samples) before being converted or left alone — a first pass generalized "列ベース always means columnar" from a few examples and wrongly converted 6 "column-based" sites; caught and reverted after re-checking each of the 19 列ベース sites' actual EN wording one by one.

Also excluded, verified as unrelated substring matches, not "columnar": 6 of 8 raw 列形式 hits (文字列形式/配列形式/オブジェクト形式 — "string/array/object format").

Verified markdownlint-cli2 clean on all touched files.

Which TiDB version(s) do your changes apply to? (Required)

  • i18n-ja-release-8.5 (TiDB Japanese documentation for TiDB 8.5 versions)

What is the related PR or file link(s)?

  • This PR is translated from:
  • Other reference link(s):

AI agent involvement

  • The changes in this PR were primarily made by an AI agent on behalf of the PR author.

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

Unifies 4 competing renderings of "columnar" into the dominant term
列指向: カラム型 (22 genuine occurrences, excluding 1 false-friend
"column type" usage in releases/release-8.5.7.md left untouched),
列ベース (19, all paired with 行ベース "row-based" contrastively —
matches EN's own asymmetric "row-based"/"columnar" root pairing, not
a JA-only symmetry worth preserving), カラムナー (2), and 列形式 (2
genuine "columnar format" sentences out of 8 raw hits — the other 6
were 文字列形式/配列形式/オブジェクト形式 "string/array/object
format" false positives from a substring match, left untouched).

27 files, 45 sites.
@ti-chi-bot ti-chi-bot Bot added area/develop This PR relates to the area of TiDB App development. missing-translation-status This PR does not have translation status info. labels Aug 27, 2026
@ti-chi-bot

ti-chi-bot Bot commented Aug 27, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign csuzhangxc for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot Bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Aug 27, 2026
@coderabbitai

coderabbitai Bot commented Aug 27, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: f5164035-10aa-492a-ad3b-0ff821dfaff7

📥 Commits

Reviewing files that changed from the base of the PR and between 3b88a18 and daedf70.

📒 Files selected for processing (1)
  • releases/release-5.4.0.md

Included review availability: Your plan provides up to 4 included reviews per hour; 2 remain after this review.


📝 Walkthrough

Walkthrough

The Japanese documentation updates TiFlash and columnar-storage terminology from older expressions to 「列指向」 across core, TiDB Cloud, and release documents. Links, anchors, metric identifiers, version values, and functional content remain unchanged.

Changes

TiFlash terminology updates

Layer / File(s) Summary
Standardize TiFlash terminology
basic-features.md, best-practices/*, develop/*, dr-solution-introduction.md, explore-htap.md, glossary.md, overview.md, production-deployment-using-tiup.md, quick-start-with-htap.md, tidb-cloud/*, releases/release-5.4.0.md
Japanese references to TiFlash and columnar storage now use 「列指向」 terminology. Existing links, anchors, metric identifiers, version values, and surrounding content remain unchanged.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Merge Risk: ⚪ Minimal · up to daedf

This PR standardizes Japanese documentation terminology without changing product behavior, and no actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly and concisely describes the main change: unifying Japanese terminology for the columnar concept.
Description check ✅ Passed The description covers the required change summary, affected version, AI involvement, scope decisions, and verification method. The related-link fields are blank, but they are non-critical and the des…
Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

Full details: Description check

Explanation

The description covers the required change summary, affected version, AI involvement, scope decisions, and verification method. The related-link fields are blank, but they are non-critical and the description is otherwise complete.

✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix-columnar-term-unification

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

The previous commit generalized too broadly. Re-checked EN wording at
every converted site individually: 6 of them literally say
"column-based" (paired with "row-based" as a matched contrastive
pair, e.g. dev-guide-create-table.md's "TiKV (row-based) or TiFlash
(column-based)"), not "columnar". Since this is a translation, each
site should mirror EN's own actual word choice rather than a single
normalized house term.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/develop This PR relates to the area of TiDB App development. missing-translation-status This PR does not have translation status info. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant